package com.qianfeng.es.service;

//
//                            _ooOoo_  
//                           o8888888o  
//                           88" . "88  
//                           (| -_- |)  
//                            O\ = /O  
//                        ____/`---'\____  
//                      .   ' \\| |// `.  
//                       / \\||| : |||// \  
//                     / _||||| -:- |||||- \  
//                       | | \\\ - /// | |  
//                     | \_| ''\---/'' | |  
//                      \ .-\__ `-` ___/-. /  
//                   ___`. .' /--.--\ `. . __  
//                ."" '< `.___\_<|>_/___.' >'"".  
//               | | : `- \`.;`\ _ /`;.`/ - ` : | |  
//                 \ \ `-. \_ __\ /__ _/ .-` / /  
//         ======`-.____`-.___\_____/___.-`____.-'======  
//                            `=---='  
//  
//         .............................................  
//                  佛祖镇楼                  BUG辟易  
//          佛曰:  
//                  写字楼里写字间，写字间里程序员；  
//                  程序人员写程序，又拿程序换酒钱。  
//                  酒醒只在网上坐，酒醉还来网下眠；  
//                  酒醉酒醒日复日，网上网下年复年。  
//                  但愿老死电脑间，不愿鞠躬老板前；  
//                  奔驰宝马贵者趣，公交自行程序员。  
//                  别人笑我忒疯癫，我笑自己命太贱；  
//  


import org.elasticsearch.action.search.SearchResponse;
import org.elasticsearch.index.query.Operator;
import org.elasticsearch.index.query.QueryBuilder;
import org.elasticsearch.search.aggregations.AggregationBuilder;
import org.elasticsearch.search.fetch.subphase.highlight.HighlightBuilder;

import java.io.IOException;

/**
 * Created by Jackiechan on 2022/6/20 16:22
 *
 * @author Jackiechan
 * @version 1.0
 * @since 1.0
 */
public interface QueryService {
    /**
     * term查询
     * @param index 库
     * @param field 列
     * @param value 值
     */
    SearchResponse termQuery(String index, String field, String value) throws IOException;

    /**
     * terms查询
     * @param index
     * @param field
     * @param value 我们的条件,可能会有多个
     * @return
     * @throws IOException
     */
    SearchResponse termsQuery(String index, String field, String... value) throws IOException;

    /**
     * 查询所有的数据
     * @param index
     * @return
     * @throws IOException
     */
    SearchResponse matchAllQuery(String index) throws IOException;

    SearchResponse matchQuery(String index,String field,String value) throws IOException;

    SearchResponse booleanQuery(String index, String field, String value, Operator operator) throws IOException;

    /**
     * 多个列match一个值
     * @param index
     * @param value
     * @param field
     * @return
     * @throws IOException
     */
    SearchResponse multiMatch(String index, String value, String... field) throws IOException;

    /**
     * 根据多个id查询
     * @param index
     * @param ids
     * @return
     * @throws IOException
     */
    SearchResponse idsQuery(String index, String ... ids) throws IOException;

    /**
     * frefix查询
     * @param index
     * @param field
     * @param value 内容的起始值
     * @return
     * @throws IOException
     */
    SearchResponse prefixQuery(String index, String field, String value) throws IOException;

    /**
     * 模糊匹配.使用?或者*来进行匹配
     * @param index
     * @param field
     * @param value
     * @return
     * @throws IOException
     */
    SearchResponse wildCardQuery(String index, String field, String value) throws IOException;

    /**
     * 范围查询
     * @param index
     * @param queryBuilder 只有调用者才知道范围是什么,所以由调用者传递
     * @return
     * @throws IOException
     */
    SearchResponse rangeQuery(String index, QueryBuilder queryBuilder) throws IOException;

    SearchResponse createScrollQuery(String index, QueryBuilder queryBuilder, int size) throws IOException;

    /**
     * 滚动查询,不需要传递库,因为所有操作都已经在创建的时候指定好了,包括库,返回的条数
     * @param scrollId
     * @return
     */
    SearchResponse scrollQuery(String scrollId) throws IOException;

    /**
     * 将查询的结果删除
     * @param index
     * @param queryBuilder
     */
    void deleteByQuery(String index, QueryBuilder queryBuilder) throws IOException;

    /**
     * 复合查询
     * @param index
     * @param queryBuilder
     * @throws IOException
     */
    void boolQuery(String index, QueryBuilder queryBuilder) throws IOException;

    /**
     * 高亮查询
     *
     * @param index
     * @param QueryBuilder     查询条件
     * @param highlightBuilder 高亮设置
     * @return
     */
    SearchResponse highLightQuery(String index, QueryBuilder QueryBuilder, HighlightBuilder highlightBuilder) throws IOException;

    /**
     * 去重的聚合
     * @param index
     * @param field 哪个列去重
     * @return
     */
    SearchResponse cardinalityAggre(String index, String field) throws IOException;

    SearchResponse rangeAggre(String index, AggregationBuilder aggregationBuilder) throws IOException;
}
